home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / mus / play / hippoplayer.lha / HippoPlayer / HiP.doc < prev    next >
Text File  |  1996-12-27  |  77KB  |  2,328 lines
  1. ******************************************************************************  
  2.  
  3.                 /\       ___.                    ___.
  4.               _/  \____ |   |_________/\ ______ |   | _________
  5.               \___|    \|   \    __  /  \\_    \|   |/   _____/
  6.            Mb /   |     \   |\___  \/  | \|     \   /   __/ \
  7.              /    |   \     |   /   \  _  \   \    /    |    \
  8.             /     |___|\    |_______/  |___\__|\   \__________\
  9.        *---/______|-----\___|----/_____|--------\___|--------------*
  10.                     ** Hippopotamus Design Presents: **
  11.  
  12.                          *** HippoPlayer v2.36 ***
  13.  
  14.                      Copyright © 1994-1997 K-P Koljonen
  15.                               ** SHAREWARE **
  16.  
  17. ******************************************************************************
  18.  
  19.  
  20. HippoPlayer (HiP) is a multiformat module player for the Amiga.  It works
  21. perfectly under Kickstart 1.2 and has all the same and even more features
  22. than the players requiring Kick2.0+ to run.
  23.  
  24. One main reason why I started making this program was that there were no
  25. good Kick1.3 compatible players around, or I didn't know of one (that was
  26. back in 1994 when I had an A500).  The other reason was that my good friend
  27. Jarno Paananen (Guru/Sahara Surfers) made a replay routine for
  28. Screamtracker ]I[ modules, and I wanted a good GUI for it.
  29.  
  30. The aim was to make a good module player that works on every Amiga
  31. configuration and has lot's of useful features.  To achieve speed,
  32. little size and memory usage, HiP is entirely written in assembler.
  33. Project HippoPlayer was started 5.2.1994.
  34.  
  35. "Newcomers will run screaming away", said Nemesis1.  At first HiP may seem
  36. complicated.  Learn to use HiP, it should be worth the effort :)...
  37.  
  38. HiP has good support for Screamtracker ]I[, Fasttracker 1 & 2, Taketracker,
  39. and Multitracker modules (from here onwards referred as PS3Ms,
  40. meaning that you can listen them with a 68000 Amiga with listenable
  41. quality.  All are played by the famous replayer by Guru.  HiP was the
  42. second (or was it third?) program to use the PS3M-routines after Guru's own
  43. player.
  44.  
  45.  
  46. Some features in HippoPlayer
  47.  
  48.  · Screamtracker ]I[, Fasttracker 1 & 2, Taketracker, Multitracker, 1 to 32ch
  49.  
  50.  · SID-emulation by Håkan Sundell & Ron Birk (works even on kick1.2)
  51.  
  52.  · TFMX-modules, normal and the seven channel ones
  53.  
  54.  · A bunch of 4-8 channel sample & synth music formats
  55.  
  56.  · Easy to use, nice 3D-interface
  57.  
  58.  · Keyboard control
  59.  
  60.  · AppWindow
  61.  
  62.  · ARexx
  63.  
  64.  · Public screen support
  65.  
  66.  · Internal multitasking
  67.  
  68.  · Loads and decompresses XPK, FImp, PowerPacker, LhA, LZX and Zip files.
  69.  
  70. HippoPlayer has been tested on:
  71.  
  72.  A500/000/7MHz, kick 1.2, 0.5+0.5M memory (my old Amiga)
  73.  A500/000/7MHz, kick 1.3, 0.5+0.5M memory
  74.  A500/000/28MHz, kick 3.1, 1+2M memory
  75.  A1200/020/14MHz, kick 3.0, 2+0M memory
  76.  A1200/030/28MHz, kick 3.0, 2+4M memory (my Amiga)
  77.  A1200/030/50Mhz, kick 3.0, 2+4M memory
  78.  A4000/040/25MHz, kick 3.1, 2+8M memory
  79.  
  80. HippoPlayer was/is developed on:
  81.  v1.00-v1.25   A500/010,  Kickstart 1.3/3.1, 1+2M memory, HD
  82.  v1.27-v1.40   A1200/020, Kickstart 3.0,     2+0M memory, HD
  83.  v2.00-v?.??   A1200/030, Kickstart 3.0,     2+4M memory, HD
  84.  
  85.  
  86.  
  87. ******************************************************************************
  88. *                            *** Registration ***                     *
  89. ******************************************************************************
  90.  
  91. HippoPlayer is shareware and copyright © 1994-96 K-P Koljonen.
  92.  
  93. I started making HippoPlayer on 5.2.1994, and since then I have spent
  94. countless of hours coding and debugging, trying to please the demanding
  95. users. It's not been easy or fun, but hard work!
  96.  
  97. So if you like using HiP and would like to encourage me to continue
  98. developing it and help me as well (as I'm a poor student ;), you really
  99. should consider registering.
  100.  
  101. To register, send a disk and some money to my address (see About).
  102. Remember to mention your address!  And DO SEND A DISK!!
  103.  
  104. Amount of money needed for the registration in different currencies:
  105. FIM: 40
  106. CAD: 12
  107. DEM: 14
  108. GBP: 6
  109. NOK: 57
  110. SEK: 60
  111. USD: 9
  112.  
  113. These are all exactly worth 40 FIM, but I can't exchange coins so you
  114. should round the amount so that you can send notes (bills).
  115.  
  116. Other currencies are ok too, at least those used in Europe.
  117.  
  118. You will get the disk back with the latest version of HiP and a key file,
  119. which you must not spread (no point in doing that anyway).  It is for your
  120. own use only.  This key file will work with possible future versions too.
  121.  
  122. Registering by e-mail is also possible.  Send the money by normal mail (no
  123. need for disk) and I will mail you the key file.
  124.  
  125. There's no functional difference between registered and unregistered
  126. version!
  127.  
  128. Support quality software, register.
  129.  
  130.  
  131. ******************************************************************************
  132. *                            *** Distribution ***                     *
  133. ******************************************************************************
  134.  
  135. HippoPlayer can be freely distributed as long as all files are included
  136. unaltered.  Not for commercial use without a permission from the author.
  137.  
  138. Amiga magazines wishing to put HiP into a cover disk should send me the
  139. corresponding maggy number for free.
  140.  
  141.  
  142.  
  143. ******************************************************************************
  144. *               *** How and where to get the latest versions ***             *
  145. ******************************************************************************
  146.  
  147. How and where to get the latest versions
  148. ----------------------------------------
  149.  
  150. To obtain the latest version of the HippoPlayer via modem, follow the
  151. instructions below.
  152.  
  153. 1. Dial The Chameleon BBS: +358-08-5409545
  154.                            +358-08-5409545
  155.                            +358-08-5546450
  156.  
  157. 2. Select the display mode that suits your needs.
  158.  
  159. 3. In the handle prompt, enter `support'.
  160.  
  161. 4. To browse the filelist, enter `NEW 2' and use either `T'ag command, or
  162.    cursor keys to select the files you want to download.
  163.  
  164. 5. If you want to report some bugs or suggest improvements to the developer
  165.    of HippoPlayer (K-P) enter `E' and address the message to `K-P'. If you
  166.    want to, you can make it a private message by entering `Y' to the query.
  167.  
  168. 6. If you've got some software related to HippoPlayer, that you would like to
  169.    be spread, you can upload it to the HippoPlayer-directory with the `U'
  170.    command. Please place the file in the HippoPlayer directory (2) and
  171.    describe the file.
  172.  
  173. 7. To leave the BBS simply enter `G'
  174.  
  175. ---
  176.  
  177. You can also try the JuJu mAgicBoArD.  Ask Zymosis membahs for numbahs. :)
  178.  
  179. ---
  180.  
  181. Those who have access to aminet can go and download HiP from
  182. mus/play/hippoplayer.lha.
  183.  
  184. ---
  185.  
  186. WWW surfers can go and get HiP from http://kalahari.ton.tut.fi/~k-p
  187.  
  188. Public beta versions will also be available there.
  189.  
  190.  
  191.  
  192. ******************************************************************************
  193. *                           *** Requirements ***                     *
  194. ******************************************************************************
  195.  
  196. Hardware:
  197.   Any Amiga with some memory and Kickstart 1.2 or higher.
  198.  
  199. Software:
  200.   reqtools.library (any version)
  201.  
  202.   There is Kick1.3 reqtools.library included in the archive.
  203.  
  204. The following software is not required, but recommended:
  205.  
  206.   In order to...                  you need...
  207.   ------------------------------------------------------------------
  208.   Use the AHI audio system        to install the AHI audio system :)
  209.   Load XPK files                  xpkmaster.library and some sublibs
  210.   Load PowerPacker files          powerpacker.library
  211.   Load lha, lzx and zip files     to look at archivers
  212.   Load other packed file formats  to have xfdmaster.library
  213.   Play SID files                  PlaySID.library
  214.   Play 4ch MED modules            medplayer.library V5+
  215.   Play 5-8ch MED modules          octaplayer.library V5+
  216.   Play 1-64ch OctaMED SS modules  octamixplayer.library V7+
  217.   Play MusiclineEditor modules      mline.library
  218.  
  219. The player libraries are found in the archive.
  220.  
  221. reqtools.library and powerpacker.library copyright © Nico François.
  222. xpkmaster.library copyright © Urban Dominik Müller.
  223. PlaySID.library copyright © Per Håkan Sundell & Ron Birk.
  224. medplayer, octaplayer and octamixplayer libraries copyright © Teijo Kinnunen.
  225. xfdmaster.library copyright ©  Georg Hörmann.
  226. AHI audio system copyright © Martin `Leviticus' Blom.
  227. mline.library copyright © Conny & Christian Cyréus
  228.  
  229.  
  230.  
  231.  
  232. Installation
  233. ------------
  234.  
  235.  · Copy HiP and one of the info-files to wherever you keep your tools.
  236.  
  237.  · Copy HippoPlayer.group into S: or define the location later in
  238.    the preferences.
  239.  
  240.  · Copy HippoPlayer.PS3M into S:.
  241.  
  242.  · Copy the player libraries from libs-dir to Libs:. 
  243.  
  244.  · Copy reqtools.library in LIBS:
  245.    Note: If you already have reqtools.library installed, you should check
  246.          the version of it and the version of the library included in the
  247.          HippoPlayer archive. You should have the newest version in LIBS:.
  248.  
  249.  
  250.  
  251. ******************************************************************************
  252. *                           *** Music formats ***                     *
  253. ******************************************************************************
  254.  
  255. Explanation of the list:
  256.  
  257. Stop/Continue     = 1 - The music can be stopped and continued.
  258. Multiple songs    = 2 - Modules can have more than one song.
  259. Volume            = 3 - Volume can be controlled.
  260. End detect        = 4 - Songend can be detected.
  261. Forward/backward  = 5 - You can jump forwards and backwards in the song.
  262. CIA fast forward  = 6 - Play 2x or 4x faster with LMB/RMB and `>'
  263. AHI support       = 7 - Music can be played thru the AHI device.
  264.  
  265. The module formats marked with a star (`*') have the replay code inside the
  266. module itself.  I can't guarantee will they work or not.  This is also the
  267. reason why they are not in the player group file (no replay code).
  268.  
  269. Replayer                        1234567    Author
  270. --------------------------------------------------------------------
  271. Built-in replayers
  272.  
  273. David Whittaker                 xx---x-*  David Whittaker
  274. Delta Music v2.0                x-x--x-*  Bent Nielsen
  275. Fred                            xx---x-*  Frederic Hahn & JC
  276. Hippel                xx---x-*  Jochen Hippel
  277. Maniacs of Noise                xxx--x-*  Maniacs of Noise
  278. Mark II                         x----x-*  Cachet Software
  279. MED 1-64ch                      xx-xx--   Teijo Kinnunen
  280. Music Assembler                 x-x--x-*  Oscar Giesen & Marco Swagerman
  281. MusiclineEditor            xxx----   Conny & Christian Cyréus
  282. Old Soundtracker        xxxxxx-      K-P Koljonen
  283. Protracker                      xxxxxxx   K-P Koljonen
  284. PSID                            xx--x--   Håkan Sundell & Ron Birk
  285. SIDMon v1.0                     x----x-*  Reiner van Vliet
  286. Sonic Arranger                  -x-----*  Carsten Schlote
  287.  
  288. Replayers in player group file
  289.  
  290. BP SoundMon v2.0                x-xxxx-   Brian Postma
  291. BP SoundMon v3.0 (v2.2?)        x-xxxx-   Brian Postma
  292. DIGI Booster                    x-xxx--   Tomasz Piast (Tap)
  293. Fasttracker 1                   x-xxx-x   Jarno Paananen
  294. Fasttracker 2                   x-xxx-x   Jarno Paananen
  295. Future Composer v1.0-v1.4       x-xx-x-   SuperSero (of the Superions)
  296. Hippel-COSO            xxxx-xx   Jochen Hippel
  297. IFF 8SVX/RIFF WAVE/AIFF samples x-xx---   K-P Koljonen
  298. JamCracker                      x--x-x-   M. Gemmel
  299. Multitracker                    x-xxx-x   Jarno Paananen
  300. Oktalyzer                       --xx---   Armin Sander
  301. Taketracker            x-xxx-x   Jarno Paananen
  302. TFMX                            xxxxx--   Chris Hülsbeck
  303. TFMX 7ch                        xxxxx--   Chris Hülsbeck & Jochen Hippel
  304. The Player 6.1A                 x-x----   Jarno Paananen
  305. THX Sound System                xxxx-x-   Martin Wodok (Dexter/Abyss)
  306. Screamtracker 3                 x-xxx-x   Jarno Paananen
  307.  
  308.  
  309.  
  310. Player group (See Prefs)
  311. ------------
  312.  
  313. Player group (HippoPlayer.group) is a file consisting of the replayers
  314. not included in the main program.  The reason for this is that by moving
  315. seldom used replayers into a separate file, memory usage is reduced by
  316. about 40-50kB.  Not that much you may think, but maybe just enough to
  317. prevent some actions from happening on low memory systems/situations.  You
  318. can decide where HippoPlayer is to look for the player group file in the
  319. preferences.
  320.  
  321.  
  322.  
  323. Loading files
  324. -------------
  325.  
  326. Normally all modules will be loaded in CHIP. 
  327.  
  328. The following formats can be played from FAST RAM and are loaded there if
  329. possible:
  330. - SID
  331. - PS3M
  332. - TFMX (only song data, samples are always in CHIP)
  333. - Oktalyzer 8 channel modules
  334. - OctaMED 8-64 channel modules
  335. - Protracker (only if you have selected PT FAST RAM play)
  336. - DIGI Booster
  337. - THX
  338.  
  339. · Compressed files are loaded to CHIP and then inspected if they should be
  340.   moved to FAST.
  341.  
  342. · XPK packed files can be identified by unpacking the first chunk of the
  343.   file.  That hunk will be used to determine whether the module should be
  344.   loaded to FAST.
  345.  
  346. · LhA, LZX and Zip files can be checked for loading to FAST.
  347.  
  348.  
  349. Advantages of loading to FAST:
  350.  · FAST RAM is much faster than CHIP, so mixing and other processing 
  351.    can be done faster.
  352.  · CHIP RAM is saved for other applications.
  353.  
  354.  
  355.  
  356.  
  357. Protracker
  358. -----------
  359. Protracker is the most popular music format on the Amiga.  HiP features my
  360. own Protracker play routine.
  361.  
  362.  · Multisong modules
  363.  
  364.    There are some modules around with several songs separated by the B
  365.    command.  HiP allows you to play these kind of modules correctly.  Just
  366.    use the '|<' and '>|' gadgets (or the respective keys) to select
  367.    different songs. The first player on Amiga to support this feature :)
  368.  
  369.  · Fast RAM player
  370.  
  371.    This player can play PT modules from FAST RAM using only 1024 bytes of
  372.    CHIP RAM.  Useful for very big modules.  
  373.  
  374.  · Old Soundracker modules
  375.  
  376.    HiP identifies old Soundtracker modules and converts them to the
  377.    Protracker format. This will take memory temporarily twice the module
  378.    size, but I don't think it's a big problem because old ST tunes tend to
  379.    be very small.
  380.  
  381.  
  382.  
  383. TFMX
  384. ----
  385.  
  386. HiP can play both 4 and 7-channel TFMX modules, including the excellent
  387. Turrican 1, 2 and 3 intro tunes.  A TFMX module consists of two files.
  388. They must be named `mdat.<name>' and `smpl.<name>'.  To play, select
  389. `mdat.<name>'.  HippoPlayer will then try to load the `smpl.<name>' file.
  390. Alternatively you can use the TFHD format TFMX modules.
  391.  
  392. The mixing rate of TFMX 7 channel replayer can be changed.  The bigger
  393. value, the better quality and bigger CPU load.  If you lose notes or hear
  394. `crackling' in the sound try lowering the mixing rate in the preferences.
  395.  
  396.  
  397.  
  398. PS3M 0.960/020+ (22.2.1996)
  399. ---------------------------
  400. In the term `PS3M', the following formats apply:
  401.  
  402.  · Screamtracker ]I[
  403.  · Protracker
  404.  · Fasttracker 1 & 2
  405.  · Taketracker
  406.  · Multitracker
  407.  
  408. Jarno Paananen (Guru/Sahara Surfers) has made replayers for these.  They
  409. have been integrated to a mixing engine which is able to play 1-32 voices
  410. simultaneously by mixing them through four channels.  The routine is
  411. amazingly fast.  Even on Amiga 500 eigth channel modules are very
  412. listenable.  The replayer gobbles quite a bit of memory for its buffers, so
  413. don't be surprised.
  414.  
  415. Mixing rates can be changed.  Again, the bigger value, the better quality
  416. and bigger CPU load.  Using the system friendly mode on A500 will probably
  417. more or less jam the machine, therefore you should use the killer mode for
  418. the best quality.
  419.  
  420. PS3M allows mixing rates higher than 28 kHz, which is normally the hardware
  421. limit.  In some AGA (ECS too?) screenmodes higher mixing rates are
  422. possible.  This is what I found out after some experimenting.  I used
  423. maximum overscan.
  424.  
  425.                  Maximum mixing rates for screenmodes 
  426.  
  427.                         PAL          28 kHz        
  428.                         NTSC         28 kHz
  429.                         Euro36       28 kHz
  430.                         DblPAL       54 kHz
  431.                         DblNTSC      54 kHz
  432.                         Euro72       58 kHz
  433.                         Multiscan    58 kHz
  434.                         Super72      46 kHz
  435.  
  436. Note: If you use too high a mixing rate, the sound will be distorted.
  437.  
  438. The 14-bit mode supports CyberSound calibration for the best possible
  439. quality.
  440.  
  441. Killer mode will cause Enforcer hits!  It bangs some of the
  442. interrupt vectors.  Don't use Enforcer with killer mode.
  443.  
  444. These modules can and should be played from FAST RAM.
  445.  
  446. PS3M can be configured via the preferences or a configuration file.
  447.  
  448.  
  449.  
  450.  
  451. PS3M configuration file
  452. -----------------------
  453.  
  454. It is possible to control PS3M via the config file `S:HippoPlayer.PS3M'.
  455. HiP will configure PS3M according to the config file every time a module is
  456. loaded.
  457.  
  458. In HippoPlayer.PS3M you can enter PS3M settings for each number of channels
  459. and for specific modules.  In channel and song settings you may replace the
  460. number you don't want to alter with ?'s.  Useful when you want to control
  461. the mixing rate from HiP and the volume boost the PS3M from config file.
  462.  
  463. The file is quite self-explanatory so you should be able to edit it with no
  464. problem.  If you don't want to use the config file you can delete it from
  465. S:  or disable it from prefs.
  466.  
  467.  
  468.  
  469. SID
  470. ---
  471. These are tunes ripped from C64 games & demos.  Both normal file + icon and
  472. one file formats are supported.  The playing is done by PlaySID.library by
  473. Håkan Sundell and Ron Birk.  Great job dudes!
  474.  
  475. *** Note 1:  Under Kickstart 1.2/1.3 playsid.library v1.1 does not work
  476. because it uses some Kick2.0+ functions.  I have made a little patch to
  477. bypass the problem.  This patch works ONLY with lib version v1.1 and
  478. Kick1.2/1.3.
  479.  
  480. *** Note 2:  If you are using the excellent Executive you should switch it
  481. to use some other timer than CIAB because playsid.library needs the CIAB
  482. timers for playing.
  483.  
  484.  
  485.  
  486. MED
  487. ---
  488. HippoPlayer supports different MED formats:  MMD0, MMD1, MMD2, and MMD3.
  489.  
  490. 4 channel tunes are played with medplayer.library version V6 or higher.
  491. 5-8 channel tunes are played with octaplayer.library version V6 or higher.
  492. 1-64 channel tunes (made OctaMED SoundStudio) are played with
  493. octamixplayer.library version V7 or higher.
  494.  
  495. The few configurable items have been implemented by using the PS3M settings
  496. in Prefs. They are as follows:
  497.  
  498. - High Quality mode with 5-8 channel modules and octaplayer.library is
  499. toggled on when the PS3M mixing rate is at least 25000 Hz.  Otherwise it's
  500. off.
  501.  
  502. - The mixing rate when using 1-64 channel modules and octamixplayer.library
  503. is the same as the mixing rate in the PS3M settings.
  504.  
  505. - The play mode when using 1-64 channel modules and octamixplayer.library
  506. is 8-bit unless you have 14-bit stereo set in PS3M settings.  If so,
  507. octamixplayer.library will also use 14-bit output.
  508.  
  509.  
  510.  
  511. AHI audio system
  512. ----------------
  513.  
  514. AHI (Audio Hardware Inferface) device and driver based audio system by
  515. Martin Blom <lcs@lysator.liu.se>.
  516.  
  517. The replayers in HippoPlayer that currently support AHI are: 
  518.  · Protracker, Screamtracker 3, Fastracker 1 & 2, Multitracker,
  519.    Taketracker, Hippel-COSO.
  520.  
  521. These music formats can thus be played thru any audio card that has an AHI
  522. driver installed.  Amiga's own audio hardware can of course be used too
  523. (there are 8-bit and 14-bit modes available). 
  524.  
  525. At least the following sound cards are currently supported:
  526.  · Delfina
  527.  · Toccata
  528.  · Wavetools
  529.  · Prelude
  530.  
  531. Configure AHI from preferences.
  532.  
  533. AHI requires at least kickstart 2.0.
  534.  
  535. ** NOTE!  Don't try to use the external scopes while using AHI.  You have
  536. been warned.
  537.  
  538.  
  539.  
  540. Audio samples
  541. -------------
  542. HiP is able to play the following audio sample formats:
  543. - IFF 8SVX 8-bit mono/stereo
  544. - AIFF 8/16-bit mono/stereo
  545. - RIFF WAVE PCM 8/16-bit mono/stereo
  546.  
  547. Samples can be unlimited in length because the data is loaded in small
  548. parts while playing.  Some chip ram is needed for buffers (the amount can
  549. be adjusted from prefs).
  550.  
  551. As default 16-bit samples are converted to 8-bit samples before playing.
  552. However, much better sound quality can be achieved by selecting 14-bit
  553. output.  This can be done from Prefs under PS3M settings, where you should
  554. enable the CyberSound calibration.
  555.  
  556. There's no 'standard' 14-bit output available for sample playing, the only
  557. choices are 8-bit output and 14-bit calibrated output.
  558.  
  559. Also note that with 14-bit sample output the volume gadget has no effect at
  560. all.  This is because of the special way of outputting the sound.
  561.  
  562.  
  563.  
  564. ******************************************************************************
  565. *                        *** How to use HippoPlayer ***                      *
  566. ******************************************************************************
  567.  
  568. The main window is an AppWindow.  You can drop icons onto it and they will
  569. be added to the list and played.
  570.  
  571. --------------------------
  572. *** Gadgets & keyboard ***
  573. --------------------------
  574.  
  575. Keyboard shortcuts are bracketed.  The keys work from both main window and
  576. prefs window.
  577.  
  578.  
  579.  |<<    Load and play previous module. 
  580.     Keyboard: [K]
  581.     Number pad: [4]
  582.  
  583.  |<    Play previous subsong.
  584.     Keyboard: [ARROW LEFT]
  585.     Number pad: [4]
  586.  
  587.  <<    Backward, jump to previous pattern.
  588.     Keyboard: [,]
  589.     Number pad: [1]
  590.  
  591.  >    Load and/or play selected module. If nothing selected, pop up
  592.     file requester. [RETURN/ENTER]
  593.  
  594.  >>    In general this function jumps forward one song position.
  595.  
  596.     If the module format supports pos/len:
  597.  
  598.     · Left mousebutton + `Forward' = Jump one position forward
  599.       Keyboard: [.], number pad [3]
  600.  
  601.     · Right mousebutton + `Forward' = Double the playing speed
  602.       Keyboard: [SHIFT+.], [SHIFT] + number pad [3]
  603.  
  604.     If the module format doesn't support pos/len:
  605.  
  606.     · Left mousebutton + `Forward' = Double the playing speed
  607.       Keyboard: [.], number pad [3]
  608.  
  609.     · Right mousebutton + `Forward' = Quadruple the playing speed
  610.       Keyboard: [SHIFT+.], [SHIFT] + number pad [3]
  611.  
  612.     To restore the normal playing speed, you can do one of the following:
  613.  
  614.     · Click `Forward' button.
  615.     · Press `Forward' key [.], number pad [3].
  616.     · Click `Pause' button two times.
  617.     . Press `Pause' key two times.
  618.  
  619.     Keyboard: [.]
  620.     Number pad: [3]
  621.  
  622.  >|    Play next subsong.
  623.     Keyboard: [ARROW RIGHT]
  624.     Number pad: [6]
  625.  
  626.  >>|    Load and play next module.
  627.     Keyboard: [L]
  628.     Number pad: [6]
  629.  
  630.  ||    Stop & continue playing (=pause). 
  631.     Keyboard: [SPACE]
  632.     Number pad: [5]
  633.  
  634.  ^     Stop playing and eject the current module.  The memory allocated
  635.     for the module will be freed.
  636.     Keyboard: [TAB]
  637.  
  638.  i    Open the module info window.  Various pieces of information of the
  639.     currently loaded module are displayed in the window.
  640.  
  641.     Scroll text with the scrollbar or with the arrow keys (faster 
  642.     scroll with shifts).  The window can be closed by clicking 'i'
  643.     again, pressing the [I] key, clicking the window close gadget
  644.     or clicking right mouse button on the window.
  645.  
  646.     Sample names are shown if the module is one of the
  647.     following formats: Protracker, DIGI Booster, Screamtracker ]I[, 
  648.     Fasttracker 1 & 2, Taketracker, Multitracker.
  649.  
  650.     Sample playing
  651.     --------------
  652.  
  653.     Only for Protracker modules that have been loaded to Chip memory. 
  654.     (The PT replayer must be set to 'Normal'.)
  655.  
  656.     To play a sample click left mousebutton on a sample name.  The
  657.     note of the sample can be defined by the X coordinate of the
  658.     mousepointer:  the leftmost edge of the window is C-1 and the
  659.     rightmost edge B-3.
  660.  
  661.  Right mousebutton + i
  662.     Open the about window. Otherwise the same as above.
  663.         Keyboard: [HELP]
  664.  
  665.  Horizontal slider
  666.     Volume controller. 
  667.     Keyboard: [V], [B]
  668.     Number pad: [-], [+]
  669.  
  670.  New    Clear the module list, select new modules and play the first one.
  671.     Keyboard: [N]
  672.  
  673.  Right mousebutton + New
  674.     Clear the module list.
  675.     Keyboard: [C]
  676.  
  677.  Add    Add modules to the end of the list using file requester.  
  678.     You can also select directories; HiP will perform a recursive 
  679.     directory scan adding all encountered files and dirs.
  680.  
  681.     Each added directory can have its own list divider.
  682.  
  683.     The file requester is the Reqtools.library file requester.
  684.     To select multiple files and dirs click files with shift pressed.
  685.     
  686.     Keyboard: [A]
  687.     Number pad: [0]
  688.  
  689.  
  690.  Right mousebutton + Add
  691.     The same as `Add', but the added files are inserted after
  692.     the currently selected file in the list.
  693.  
  694.     Keyboard: [I]
  695.     Number pad: [/]
  696.  
  697.  
  698.  Del    Delete selected module from the list.
  699.     Keyboard: [D], [BACKSPACE]
  700.     Number pad: [[]
  701.  
  702.  Right mousebutton + Del
  703.     Delete selected file from the list and from the disk.
  704.     Be Careful.
  705.  
  706.     Using this function on a divider will remove the divider and all
  707.     the files below that particular divider from the list.
  708.  
  709.     Notice that when using the gadget, a `Are you sure?' requester 
  710.     will pop up, but while using the keyboard, no warnings are given.
  711.  
  712.     Keyboard: [SHIFT+D], [SHIFT+BACKSPACE]
  713.  
  714.  Prg    Pop up a file requester for selecting a module list file to load.  
  715.     The existing module list will be cleared.
  716.  
  717.     Keyboard: [P]
  718.     Number pad: [.]
  719.  
  720.  
  721.  Right mousebutton + Prg
  722.     Save the contents of the list to a module program file.
  723.     Keyboard: [W]
  724.  
  725.  M    Remove a module from the list.  To insert it back press [M]
  726.     again (also play button (symbol: `>', key: [RETURN] or [ENTER]) 
  727.     will do).
  728.  
  729.     Keyboard: [M]
  730.     Number pad: []]
  731.  
  732.  Right mousebutton + M
  733.     Insert a list divider into the list.  With list dividers you 
  734.     can create sections into the list, for example a divided section
  735.     for each composer etc.  See Prefs.
  736.  
  737.     Keyboard: [Q]
  738.  
  739.  S    Sort list alphabetically.  With lot's of files this may be a 
  740.     bit slow  (I'm using bubble sort :-).  Divided sections in 
  741.     list are sorted separatedly.
  742.     Keyboard: [S]
  743.  
  744.  Right mousebutton + S
  745.     Find a text string from the module list according to a 
  746.     search pattern. [SHIFT+F] acts as a continue search-button.
  747.  
  748.     Keyboard: [F], [SHIFT+F]
  749.  
  750.  
  751.  Pr    Pop up the prefs window.  You can also close it with this button.  
  752.     Note that all the keys work from the activated prefs window too.
  753.     Keyboard: [R]
  754.  
  755.  Right mousebutton + Pr
  756.     Removes & restores the main window filebox.
  757.  
  758.  The leftmost propgadget
  759.     You can scroll the module list by dragging this slider around.
  760.  
  761.  
  762.  LMB on the left 1/3 of the infobox
  763.     See `i' above.
  764.  
  765.  RMB on the left 1/3 of the infobox
  766.     Open and close the scope window.
  767.     
  768. Other keys
  769. ----------
  770. [ARROW UP] and [Number pad 8]: 
  771.                Select previous module.
  772. [ARROW DOWN] and [Number pad 2]:
  773.                Select next module.
  774.  
  775. [*]:           Randomize and play a module.
  776.  
  777. [F1-F10]:      Load & play a module or a module program.
  778.                You can configure the function keys from prefs.
  779.  
  780. [Z]:           Open/close the scope window.
  781.  
  782. [7/8/9/0]:     Titlebar info selector:
  783.                7 = time, pos/len, song number
  784.                8 = clock, free memory
  785.                9 = module name
  786.                0 = time, duration, pos/len
  787.  
  788. [G/H]:         Quick setting of the play mode:
  789.                G = Set playmode to `List repeatedly'.
  790.                H = Set playmode to `Modules in random order'.
  791.  
  792. [[]:           Join a module program to the end of the module list.
  793.                See `Prg'.
  794.     
  795. [~]:           Zip/unzip window so that only the titlebar is shown
  796.                and back to the original size.
  797.  
  798.                You can do the same thing by doing the following:
  799.                · Click the window zoom gadget.
  800.                · Click the right mousebutton on something that doesn't
  801.                  have a RMB function.
  802.  
  803.                This button can also be used to bring the HiP window 
  804.                to front with the hotkey. Useful if you have lost
  805.                it amongst dozens of screens and other windows.            
  806.  
  807. [LAMIGA+LSHIFT+CONTROL]: The hotkey combination.
  808.  
  809. Press [HOTKEY]+[key] to use the HiP-keys WITHOUT first activating the
  810. window.  This is one of the two ways (the other is ARexx) to control HiP
  811. when it is hidden!
  812.  
  813.                [HOTKEY] + [H]: Hide the HiP main window completely.
  814.                                This key also reveals the hidden window.
  815.                                Also the key [~] will do, see above.
  816.                [HOTKEY] + [1]: Zip/unzip window for hotkeys. See [~].
  817.  
  818.  
  819.  
  820.  
  821. Filebox
  822. -------
  823. This is the module list.  There are two ways of selecting modules:
  824.  
  825. · Click left mousebutton on one of the names.
  826.  
  827. · Use arrow keys up and down to scroll the list. Shift increases
  828.   scrolling speed.
  829.  
  830. The selected item will be enclosed in a selection bar.
  831.  
  832.  
  833.  
  834. Right mousebutton
  835. -----------------
  836. Pressing the right mousebutton will shrink the window so that only the
  837. titlebar is shown.  Press again on the activated window to expand.
  838.  
  839.  
  840.  
  841. ******************************************************************************
  842. *                              *** Prefs ****                     *
  843. ******************************************************************************
  844.  
  845. By clicking on the Prefs gadget you can configure HippoPlayer by using the
  846. gadgets.  Multiple choice requester can be invoked by pressing right
  847. mousebutton on the cycle gadgets with `ears'.
  848.  
  849.  
  850. Play
  851. ----
  852.  · List repeatedly
  853.    Play module list over and over.
  854.  
  855.  · List once
  856.    Play list once and stop.
  857.  
  858.  · Module repeatedly
  859.    Play one module over and over.
  860.  
  861.  · Module once
  862.    Play one module once and stop.
  863.  
  864.  · Modules in random order
  865.    Play  modules  in random order.  When playing has started, same module
  866.    will not be played twice unless all modules have been played first.
  867.  
  868. `Play'  only  affects  the  replayers  where  the  end of the song can be
  869. detected.
  870.  
  871.  
  872.  
  873. Timeout
  874. -------
  875. Set playing time (mins:secs).  Disabled in the leftmost position.  Timeout
  876. can affect all modules or only those which the end can't be detected from.
  877. You can select this by pressing 'Timeout'.
  878.  
  879. Example:  Play Protracker-modules until they end and PSIDs for, say 3
  880. minutes.  Or you can play all kinds of modules for only 30 secs (intro scan
  881. :)
  882.  
  883.  
  884.  
  885. Alarm
  886. -----
  887. Set a time for HiP to play a module (same as startup module).  Control
  888. alarm with the slider, hh:mm.  To enable alarm, set titlebar info to clock.
  889. To re-enable alarm, switch titlebar info to something else and then back to
  890. clock.
  891.  
  892.  
  893.  
  894. Startup
  895. -------
  896. When enabled (with the checkbox left to alarm), HiP will start playing
  897. immediately on startup.  The module or the program to be played can be
  898. chosen by clicking the 'Startup' gadget.
  899.  
  900.  
  901.  
  902. Function keys
  903. -------------
  904. You can install a module or a module program for each of the function keys
  905. (F1-F10) by clicking this gadget.  Then when you press a fkey, the
  906. corresponding module program or module will be loaded and played.
  907.  
  908.  
  909.  
  910. Hotkeys
  911. -------
  912.  
  913. Every key function in HiP can also be invoked by using this hotkey:
  914.  
  915. [LAMIGA+LSHIFT+CONTROL]+<key>
  916.  
  917. The purpose of the hotkey is to control HiP when the HiP window isn't
  918. active.  For example you can draw with a paint program and change the tune
  919. HiP is playing by pressing the appropriate hotkey combination.
  920.  
  921. Here you can enable/disable hotkeys.  Note that some other programs might
  922. use the same hotkey!
  923.  
  924.  
  925.  
  926. Doubleclick
  927. -----------
  928. When enabled, a module can be loaded and played by doubleclicking on its
  929. name.
  930.  
  931.  
  932.  
  933. Continue on error
  934. -----------------
  935. When this switch is enabled, errors that occur while loading will be
  936. ignored, file will be skipped and the next one will be loaded.  After five
  937. errors the procedure will be halted.
  938.  
  939.  
  940.  
  941. Early load
  942. -----------
  943. Select a pattern from end to start loading next module.  Works with formats
  944. supporting position/length.
  945.  
  946. Currently this is quite a lame function, because the newly loaded module
  947. starts to play immediately.
  948.  
  949.  
  950.  
  951. Divider / dir
  952. -------------
  953. When adding directories it is sometimes useful to have a list divider for
  954. each scanned directory.  This switch enables just that.
  955.  
  956.  
  957.  
  958. Auto sort
  959. ---------
  960. When enabled, the module list will always be sorted automatically after
  961. adding files & dirs via file requester.
  962.  
  963.  
  964.  
  965. Priority
  966. --------
  967. Select a priority for HiP's processes:  -1, 0, +1.  All excluding the
  968. scopes are affected.
  969.  
  970.  
  971.  
  972. Show (titlebar information)
  973. ----
  974.  · Time, pos/len, song
  975.  
  976.    Show  playing  time,  song  position/length  and  song number/max song
  977.    (#n/n)  depending of what kind of a module is being played, and module
  978.    name.
  979.  
  980.  · Time/duration, pos/len
  981.  
  982.    This  does  exactly the same as above with all but Protracker modules
  983.    and audio samples.  If  enabled,  HiP will calculate duration of PT
  984.    modules and audio samples and show it in the titlebar.
  985.  
  986.  · Clock, free memory
  987.  
  988.    Show clock (24h) and free Chip and Fast in kilobytes.
  989.  
  990.  · Module name
  991.  
  992.    Show module name only.
  993.  
  994.  
  995.  
  996.  
  997. Screen
  998. ------
  999. Select a public screen.  All HiP's windows and requesters will be opened on
  1000. the defined screen.  If the screen is not available, default screen will be
  1001. used (usually Workbench).
  1002.  
  1003.  
  1004.  
  1005. Filebox (size)
  1006. --------------
  1007. Define the number of files shown simultaneously in the main window.
  1008. Minimum is 3 and maximum is 50.  If the value is too big for the current
  1009. screen it will be truncated.
  1010. The filebox can be removed from the window by selecting size 0.
  1011.  
  1012.  
  1013.  
  1014. Module info (size)
  1015. ------------------
  1016. Select the amount of lines the module info window can hold.
  1017.  
  1018.  
  1019.  
  1020. Font
  1021. ----
  1022. Select a 8x8 pixel font (kick2.0+ only).  All fixed width and 8 pixel high
  1023. fonts will be scanned and only those that are 8x8 pixel fonts are
  1024. displayed.
  1025.  
  1026.  
  1027.  
  1028. Scopes
  1029. ------
  1030. Select one of the scopes by clicking the type gadget and the bar gadget.
  1031. The `Scope on/off' button or `z' key or RMB on the 1/3 of the infobox will
  1032. start it up.  You can close a scope by closing it's window, clicking the
  1033. gadget again or clicking RMB on the activated scope window.
  1034.  
  1035. These are for Protracker-modules only:
  1036.  
  1037. Quadrascope (& bars)
  1038.  - This is just like the one in Protracker.  Channel order:  1,2,3,4.
  1039. Hipposcope (& bars)
  1040.  - Couldn't invent a better name..  Bass-sounds look nice with this one.
  1041.    Channel order: 1,2,3,4.
  1042. Frequency analyzer (& bars)
  1043.  - This one's more processor intensive.  There is one for the left and the
  1044.    right side. It is supposed to display frequencies while not using
  1045.    period values. This is not FFT, but is based on Guru's strange idea...
  1046.    Bass-sounds are on the left and treble-sounds on the right.
  1047.    Bar channel order: 1,4,2,3.
  1048. Patternscope
  1049.  - Protracker-emulator... Shows pattern data, four fake VU-meters and four
  1050.    tiny period boxes.
  1051.    Channels: 1,2,3,4.
  1052. F. Quadrascope (& bars)
  1053.  - F. stands for filled. Inspired by Guru/S2's routine many years ago.
  1054.    Channels: 1,2,3,4.
  1055. Bars
  1056.  - These will try to visualize the volume and the period of each channel.
  1057.    The vertical position represents sample period and the width sample volume.   
  1058.  
  1059. There are almost the same scopes for PS3M:  Quadrascope (stereoscope),
  1060. hipposcope, frequency analyzer and filled quadrascope (stereoscope).  No
  1061. bars.
  1062.  
  1063. The sample player has monoscope and filled monoscope.
  1064.  
  1065. The scopes will need some kilobytes of memory for buffers.  They are run
  1066. with priority of -30 so that they won't interfere with anything important.
  1067.  
  1068.  
  1069.  
  1070. Prefix cut
  1071. ----------
  1072. Select filename prefix cut.  Value 3 will cut prefixes like "mod.", "xm."
  1073. etc.  from the names in the filebox.  This will also affect the sorting of
  1074. the names.
  1075.  
  1076.  
  1077.  
  1078. Player group
  1079. ------------
  1080. Status:     Player group loaded/not loaded.
  1081. Mode:        Loading conditions
  1082.         - All on startup: load the group immediately on startup
  1083.         - All on demand: load the group when there is demand for
  1084.                      a replayer
  1085.         - Disable: don't load the group and unload if already loaded
  1086.         - Load single: load a single replayer from the group 
  1087.               when needed
  1088. File:        Player group file.
  1089.  
  1090.  
  1091.  
  1092. Filter control
  1093. --------------
  1094. Filter controlled by module, filter forced off or on.
  1095.  
  1096.  
  1097.  
  1098. Fade volume
  1099. -----------
  1100. This will cause those replayers that support volume to fade music in and
  1101. out.
  1102.  
  1103.  
  1104.  
  1105. Nasty audio
  1106. -----------
  1107. Select allocation priority of the audio channels.  When on, no program
  1108. except HiP can use the channels.  PS3M uses maximum priority at all times.
  1109.  
  1110.  
  1111.  
  1112. VBlank timer
  1113. ------------
  1114. Select timing method to be used for playing: VBlank or CIA timer.
  1115.  
  1116. Use this switch if you don't want HiP to use one of the four CIA timers.
  1117. VBlank plays with wrong speed on non-50Hz screens.
  1118.  
  1119. This switch has no effect on the following:  PS3M, SID, Sonic Arranger,
  1120. TFMX, TFMX 7c, MED, The Player 6.1a, DIGI Booster.  They use their own way
  1121. of timing.
  1122.  
  1123. Tempo will be disabled when playing PT mods with VBlank timer.  Double and
  1124. quadruple playing speeds are disabled when using VBlank.
  1125.  
  1126.  
  1127.  
  1128. PT replayer
  1129. -----------
  1130.  · Normal
  1131.  
  1132.    Use normal Protracker replayer to play modules from CHIP RAM.
  1133.  
  1134.  · Fastram
  1135.  
  1136.    Play PT modules from FAST RAM.
  1137.  
  1138.  · PS3M
  1139.  
  1140.    Use Guru's PS3M to play modules from Chip or Fast.  This way you can
  1141.    use those neat modes, eg listen Protracker modules with real surround.
  1142.  
  1143.  
  1144.  
  1145. Protracker tempo
  1146. ----------------
  1147. Enable or disable Protracker tempo command.  Useful for playing old modules
  1148. that use speeds higher than $1F.  Applies also to The Player modules.
  1149.  
  1150.  
  1151.  
  1152. TFMX rate
  1153. ---------
  1154. Mixing rate for the 7-channel TFMX replayer.
  1155.  
  1156.  
  1157.  
  1158.  
  1159. Sample buffer (size)
  1160. --------------------
  1161. Define the Chip RAM buffer size for the audio sample player.  The actual
  1162. memory used is double the amount.  Small value might be good for fast HDs,
  1163. while big is be better with slower media.
  1164.  
  1165.  
  1166.  
  1167.  
  1168. Force sampling rate
  1169. -------------------
  1170. This is a setting for the audio sample player.
  1171.  
  1172. Normally the sampling rate is stored in the header of a sample.  This
  1173. slider allows you to override that rate so that HippoPlayer will use this
  1174. value instead of the one found in the sample.
  1175.  
  1176. To disable the override move the slider to the leftmost position.
  1177.  
  1178. ** NOTE!  The sampling rate can be over 28.0 kHz only with some specific
  1179. screenmodes.
  1180.  
  1181.  
  1182.  
  1183. Module directory
  1184. ----------------
  1185. Select default module directory.
  1186.  
  1187.  
  1188.  
  1189. Program directory
  1190. -----------------
  1191. Same as above but for module programs.
  1192.  
  1193.  
  1194.  
  1195. Archivers (LhA... LZX... Zip...)
  1196. ---------
  1197. HiP can decompress and play modules packed with LhA, LZX and Zip.  You need
  1198. to specify a path, a command and options for each.
  1199.  
  1200. Archives will be extracted into a temporary directory that will be created
  1201. in the user defined path (RAM:  is always the fastest while HD is good for
  1202. saving memory).  The directory is then scanned for files and the first
  1203. encountered music module will be loaded.
  1204.  
  1205. Requirements
  1206.  
  1207.  · LhA, LZX or UnZip, according to what kind of packed files you have.
  1208.    Define the exact location of each (eg dh1:bucket/lha)
  1209.  
  1210.  · `Run' and `Delete' commands in C: (or in path).
  1211.  
  1212. Hints
  1213.  
  1214.  · Archived files may be packed with XPK, FImp, Powerpacker or whatever
  1215.    format XFDmaster.library can decrunch.  For example you could use
  1216.    xpkDLTA to encipher a module and then LhA it.  Gives very good
  1217.    compression of sound related data.
  1218.  
  1219.  · You can store both TFMX mdat.* and smpl.* files in one archive!
  1220.  
  1221. Kick 1.2/1.3 note
  1222.  
  1223. LhA is probably the only one that works fine.
  1224. If the default unzip command fails you could try something like this:
  1225. 'C:unzip >nil: -o -qq "%s" -d '
  1226.  
  1227.  
  1228. Archiver commands
  1229. -----------------
  1230.  
  1231. LhA: c:lha >nil: x -IqmMNXQw "%s"
  1232.  
  1233. c:lha           the program lha with complete path
  1234. >nil:           ignore any output
  1235. x               extract files
  1236. -IqmMNXQw    I       ignore LHAOPTS variable
  1237.         q       be quiet
  1238.         m       no messages for query
  1239.         M       no autoshow files
  1240.         N       no progress indicator
  1241.         X       no need to have the .lha suffix in filename
  1242.         Qw      disable wildcards
  1243. "%s"            the %s is the archive to be extracted.
  1244.  
  1245. LZX: lzx >nil: -m -q -X0 x "%s"
  1246.  
  1247. -m -q -X0       m       no messages for query
  1248.                 q       be quiet
  1249.         X0    no need to have the .lzx suffix in filename
  1250. x               extract files
  1251.  
  1252. Zip: unzip >nil: -qq "%s"
  1253.  
  1254. -qq             qq      be very quiet
  1255.  
  1256.  
  1257.  
  1258.  
  1259. Doublebuffering
  1260. ---------------
  1261. Normally when loading a module the one that already is playing is first
  1262. ejected.  With this button you can force HiP to play the current module and
  1263. load the next one at the same time.  Useful for floppy users, no delays
  1264. between playing.  If there's not enough memory to hold two mods at the same
  1265. time, the current module will be ejected first.
  1266.  
  1267.  
  1268.  
  1269. XPK identify
  1270. ------------
  1271. When on, all XPKed files will be checked if they should be loaded in FAST
  1272. memory.  You should set this if you listen to modules played by PS3M.
  1273.  
  1274.  
  1275.  
  1276. XFDmaster library
  1277. -----------------
  1278. Use  XFDmaster.library  to  load  packed files of almost any packer format.
  1279. xfdmaster.library in Libs:  is needed of course.
  1280.  
  1281.  
  1282.  
  1283. File match pattern
  1284. ------------------
  1285. Match pattern for file requesters and for adding files.
  1286.  
  1287.  
  1288.  
  1289. PS3M settings
  1290. -------------
  1291. This replayer (by Guru/S2) can play S3Ms, XMs, FTMs, MODs and MTMs.
  1292. Some of these also affect in playing MED modules.
  1293.  
  1294. Play mode:     Playing modes (see the PS3M doc for more info, or just
  1295.                 try them out)
  1296. Priority:
  1297.     Pri -10 to +9
  1298.           Set priority for the system friendly player process.
  1299.     Killer    Disable system and stop most of the DMA to get the best
  1300.                   quality. The blue flickering represents free CPU time.
  1301.           Stop playing by pressing mousebuttons.  No enforcer!
  1302.  
  1303. Mixing buffer size:
  1304.     4kB, 8kB, 16kB, 32kB mixing buffer size.
  1305.     Smaller buffer gives faster response, but decreases the
  1306.     "backup" buffer possibly causing more "skipping".
  1307.  
  1308. Mixing rate:
  1309.     Mixing rate in kHz.
  1310.  
  1311. Volume boost:
  1312.     Makes the sound clearer and louder (use when 8 or more channels)
  1313.     You will hear the change almost immediately.
  1314.  
  1315. Stereo level:
  1316.     Works only with Surround play mode.
  1317.     You can adjust the strength of stereo. 0% is mono, 100% is stereo,
  1318.     and 50% is the normal surround value.
  1319.  
  1320. Use S:HippoPlayer.PS3M configuration file:
  1321.     Use a special configuration file for configuring PS3M.
  1322.  
  1323. use CyberSound calibration
  1324.     Set the enable switch and the name of the calibration file.
  1325.     CyberSound calibration takes effect when you have also enabled
  1326.     the 14-bit stereo mode. Also the 16-bit sample player will use
  1327.     this output mode if you have enabled it here.
  1328.  
  1329.     Creating a machine specific calibration table will decrease 
  1330.     the noise level and increase the sound quality.  This can be 
  1331.     done with 14Bit_Calibration, which can be found in
  1332.     HippoPlayer/Support/  directory.  The program belongs to
  1333.     the CyberSound audio subsystem package by Christian Buchner. Thanks!
  1334.  
  1335.       As default the calibration table will be saved to    
  1336.       ENVARC:CyberSound/SoundDrivers/14Bit_Calibration.
  1337.  
  1338.       You really should try this out! The sound quality is very good
  1339.       compared to 8-bit or standard 14-bit output! 
  1340.  
  1341.  
  1342.  
  1343. AHI audio system settings
  1344. -------------------------
  1345.  
  1346. Enable AHI:
  1347.   Makes those replayers that support AHI use it for sound output.
  1348.   The replayers that currently support AHI are:
  1349.    · Protracker, Screamtracker 3, Fastracker 1 & 2, Multitracker, 
  1350.      Taketracker, Hippel-COSO.
  1351.  
  1352. Disable non-AHI replayers:
  1353.    Do not play non-AHI supporting modules at all. An `Unknown file format'
  1354.    error will be shown.
  1355.  
  1356. Mode:
  1357.    Select AHI audio mode.
  1358.  
  1359. Mixing rate:
  1360.    The bigger value the better quality and bigger CPU load. 
  1361.    Watch out! It's easy to jam up the system with too high a value.      
  1362.  
  1363. Master volume:
  1364.    This value controls the volume level of AHI, just like volume boost
  1365.    with PS3M. Value of 0 means no boost. With too high values the
  1366.    sound will break and turn ugly. :)
  1367.  
  1368. Stereo level:
  1369.    Change the stereo level. 0% is full mono, 100% is full stereo.
  1370.  
  1371.  
  1372.  
  1373. Save, Use, Cancel
  1374. -----------------
  1375. I guess you can guess these.  If you close the prefs window it's same as
  1376. 'Cancel'ling.  The prefs-file will be saved in the S:  directory.
  1377.  
  1378. *** NOTE:  Positions of the windows and some requesters are saved too.
  1379.  
  1380.  
  1381.  
  1382. ******************************************************************************
  1383. *                        *** Command line options ***                  *
  1384. ******************************************************************************
  1385.  
  1386. Add modules to the list
  1387. -----------------------
  1388. HiP  <file2> <file2> ... <file16>
  1389.  
  1390. All the files will be added to the list and the first added one will be
  1391. played.
  1392.  
  1393.  
  1394. Load a module program
  1395. ---------------------
  1396. HiP PRGM <module program>
  1397.  
  1398. The program will be loaded and the first module will be played.  If the
  1399. playmode is set as 'Modules in random order', then a random module will be
  1400. picked and played.  Existing list will be cleared.  (The PRGM-keyword is
  1401. not necessary, but is faster in terms of disk activity.)
  1402.  
  1403. All filenames must be entered with full paths!
  1404.  
  1405. *** NOTE:  You can also do these things while HiP is ALREADY running!  This
  1406. allows you to use HiP as a command line module player.  Eg in Directory
  1407. Opus it makes a good play button.
  1408.  
  1409.  
  1410. Hide on startup
  1411. ---------------
  1412. HiP HIDE [other parameters]
  1413.  
  1414. HIDE makes HiP even more a command line player.  It will force HiP not open
  1415. it's window.  Also reqtools.library is not needed (it will be loaded later
  1416. if the window is opened).  HiP can be controlled with hotkeys (if enabled)
  1417. and/or ARexx if the window is not opened.
  1418.  
  1419.  
  1420. Quit
  1421. ----
  1422. HiP QUIT
  1423.  
  1424. If there is already one HiP running, it will be terminated.
  1425.  
  1426.  
  1427.  
  1428. ******************************************************************************
  1429. *                              *** ARexx ***                           *
  1430. ******************************************************************************
  1431.  
  1432. HiP has an ARexx port 'HIPPOPLAYER'.  It will be initialized at startup if
  1433. RexxMaster is found running.  There are some simple ARexx-examples in the
  1434. ARexx-dir.
  1435. *** Note!  The ARexx-interface is not very thoroughly tested.
  1436. If there appears any misbehaviour, please tell me!
  1437.  
  1438. Parameters in [] may be omitted, parameters in <> may not!
  1439.  
  1440. CHOOSE <num>        Choose file number <num> in list.
  1441. ADD [file]        Add file [file] to list. If not specified, open
  1442.             file requester.
  1443. DEL            Delete chosen file from list.
  1444. CLEAR            Clear list.
  1445. MOVE <num>        Move chosen module after file number <num>.
  1446. INSERT <file>        Insert file <file> after chosen file.
  1447. SORT            Sort file list.
  1448. LOADPRG [file]        Load program [file]. If not specified, open
  1449.             file requester.
  1450.  
  1451. PLAY [file]        If [file] is given, clear list and play it. Otherwise
  1452.             play chosen file. If there's no files in list then
  1453.             open file requester.
  1454. EJECT            Stop playing and free current module.
  1455. STOP            Stop playing.
  1456. CONT            Continue playing after stop.
  1457. SONGPLAY <num>        Play song number <num>.
  1458. RANDPLAY        Pick a random module and play it.
  1459. FFWD            Jump forwards in song.
  1460. REW            Jump backwards in song.
  1461. VOLUME <vol>        Set volume <vol> (0-64).
  1462.  
  1463. QUIT            Close all windows and exit program.
  1464. ZIP <0/1>        0: small main window, 1: normal main window
  1465. HIDE <0/1>        0: hide main window, 1: show main window
  1466. PUBSCREEN <screen>    Set public screen for HiP's windows & requesters.
  1467.             Note that this is case sensitive.
  1468.  
  1469. TIMEOUT <secs>        Set timeout (0-600 secs).
  1470. PS3MBOOST <value>    Set PS3M volume boost (0-8).
  1471. PS3MMODE <mode>        Set PS3M mode. 1: surround, 2: stereo, 3: mono,
  1472.             4: real surround, 5: 14-bit stereo.
  1473. PS3MRATE <rate>        Set PS3M mixing rate (5000-56000).
  1474.  
  1475. LOADPREFS <file>    Load prefs file. Restart HiP with new settings.
  1476.             HiP only saves prefs to S:HippoPlayer.prefs, so
  1477.             you have to collect them manually somewhere for
  1478.             ARexx-usage.
  1479.  
  1480. SAMPLES            Open module info window.
  1481.  
  1482. GET <xxxx>    With this command you can get different information from HiP.
  1483.         The <xxxx> can be one of the following:
  1484.         xxxx:    result:
  1485.         PLAY    0 if not playing, 1 if playing.
  1486.         CFIL    Number of chosen file, 0 if none chosen.
  1487.         NFIL    Number of files in list.
  1488.         CURR    Number of loaded module.
  1489.         NAME    Module name.
  1490.         TYPE    Module type.
  1491.         CNAM    Name of chosen file.
  1492.         CSNG    Current song number.
  1493.         NSNG    Number of songs available.
  1494.         CSPO    Current song position.
  1495.         MSPO    Maximum song position.
  1496.         FNAM    Full name of loaded file.
  1497.         COMM    File comment of loaded file.
  1498.         SIZE    Size of loaded file.
  1499.         DURA    Module duration in seconds (returns 0 if Time/
  1500.                         duration is not enabled).
  1501.         HIDS    0 if main window not hidden, 1 if hidden.
  1502.         FILT    0 if filter off, 1 if filter on
  1503.             
  1504.  
  1505. ******************************************************************************
  1506. *                              *** Developers ***                            *
  1507. ******************************************************************************
  1508.     
  1509. HiP has a tiny interface for programmers who want to c0de some scopes of
  1510. their own.  Check out the example source(s)!
  1511.  
  1512. What you do is FindPort() "HiP-Port".  If unsuccesful, HiP is not running.
  1513. Otherwise, you get the pointer to HippoPlayer's port.  It looks like this:
  1514.  
  1515.     STRUCTURE       HippoPort,MP_SIZE
  1516.     LONG            hip_private1    * Private..
  1517.     APTR            hip_kplbase     * Protracker replayer data area
  1518.     WORD            hip_reserved0   * Private..
  1519.     BYTE            hip_quit        * If non-zero, we must quit
  1520.     BYTE            hip_opencount   * Open count (see below)
  1521.     BYTE            hip_mainvolume  * Main volume, 0-64
  1522.     BYTE            hip_play        * If non-zero, HiP is playing
  1523.     BYTE            hip_playertype  * 33 = Protracker, 49 = PS3M
  1524.     *** Protracker ***
  1525.     BYTE            hip_reserved2
  1526.     APTR            hip_PTch1       * Protracker channel data for ch1
  1527.     APTR            hip_PTch2       * ch2
  1528.     APTR            hip_PTch3       * ch3
  1529.     APTR            hip_PTch4       * ch4
  1530.     *** PS3M ***
  1531.     APTR            hip_ps3mleft    * Buffer for the left side
  1532.     APTR            hip_ps3mright   * Buffer for the right side
  1533.     LONG            hip_ps3moffs    * Playing position
  1534.     LONG            hip_ps3mmaxoffs * Max value for hip_ps3moffs
  1535.     *** Protracker ***
  1536.     BYTE            hip_PTtrigger1
  1537.     BYTE            hip_PTtrigger2
  1538.     BYTE            hip_PTtrigger3
  1539.     BYTE            hip_PTtrigger4
  1540.  
  1541.     *** PT channel data block
  1542.     STRUCTURE       PTch,0
  1543.     LONG            PTch_start      * Start address of sample
  1544.     WORD            PTch_length     * Length of sample in words
  1545.     LONG            PTch_loopstart  * Start address of loop
  1546.     WORD            PTch_replen     * Loop length in words
  1547.     WORD            PTch_volume     * Channel volume
  1548.     WORD            PTch_period     * Channel period
  1549.     WORD            PTch_private1   * Private...
  1550.  
  1551. *** NOTE:  DON'T WRITE ANYTHING TO THE PORT!
  1552.  
  1553. *** hip_opencount ***
  1554.  
  1555. As soon as you get the pointer to HippoPlayer's port, add 1 to
  1556. hip_opencount.  When you are done, subtract 1 from hip_opencount.
  1557.  
  1558. *** hip_quit ***
  1559.  
  1560. If this byte becomes non-zero, your scope (or whatever) must quit.
  1561.  
  1562. *** PT hints ***
  1563.  
  1564. Each channel has it's own trigger byte:  hip_PTtrigger1, hip_PTtrigger2
  1565. etc..  When a new sample starts to play, the corresponding channel trigger
  1566. is incremented by 1.
  1567.  
  1568. PTch_start is updated so that it always points to the current playing
  1569. position of the sample.  PTch_length will decrease until it hits zero.
  1570. When this happens, PTch_start is replaced with PTch_loopstart and
  1571. PTch_length is replaced with PTch_replen.  In other words, the sample
  1572. loops.  If the loop size is 2 bytes (PTch_length = 1, PTch_replen = 1),
  1573. the sample stops (plays null).  Don't read past the sample data; always
  1574. check PTch_length.
  1575.  
  1576. The hip_kplbase points to the data area of my Protracker replayer.  This
  1577. makes it possible to do scopes like patternscope.  Contact me if you want
  1578. the structure definition.
  1579.  
  1580. *** PS3M hints ***
  1581.  
  1582. hip_ps3moffs is an offset from the start of the buffers pointing to the
  1583. current playing position.  Don't read past bufferstart+hip_ps3mmaxoffs.
  1584.  
  1585.  
  1586.  
  1587. ******************************************************************************
  1588. *                            *** Known bugs ***                  *
  1589. ******************************************************************************
  1590.  
  1591.  · Main  window  refresh  may  get dangerously confused when when zipping
  1592.    window  via zoomgadget while loading module/program, saving program or
  1593.    sorting.  One zip is allowed, two is too much, so be careful.
  1594.  
  1595.  · Timeout  and  alarm  don't  work  if  there's  no timer visible in the
  1596.    titlebar.
  1597.     
  1598.  · Some Fred modules cause enforcer hits.
  1599.  
  1600.  · Sonic Arranger tunes tend to crash sometimes.
  1601.  
  1602.  · Scopes  bug  with  PT  9xx  command.  This  one  originates  from  the
  1603.    Protracker itself (my PT replayer really is 100% PT compatible :)
  1604.  
  1605.  · If you click outside the slider but in the gadget area at the same
  1606.    time when activating a window, the gadget might not respond. I've
  1607.    heard that this is a bug in in AmigaOS.
  1608.  
  1609.  · Some mysterious bugs in ARexx... (?)
  1610.  
  1611.  
  1612.  
  1613.  
  1614. ******************************************************************************
  1615. *                              *** History ***                           *
  1616. ******************************************************************************
  1617.  
  1618. Read this!  Some things are not mentioned elsewhere!
  1619.  
  1620.  
  1621. v2.00 (19.3.1995)
  1622. -----------------
  1623.     * ARexx support
  1624.     * Public screen support
  1625.     * Keyboard control changes: you can use the keys without activating
  1626.       the window first by pressing lamiga-lshift-control-<key>.    
  1627.     * New PS3M: support for Fasttracker 2 (XM) modules.
  1628.     * Improved outlook.
  1629.     * Patched playsid.library so that it's possible to play SID-tunes
  1630.       also on kick1.2/1.3.
  1631.     * Prefs: continue on error, hotkeys, nasty audio, doublebuffering,
  1632.              program dir selector.
  1633.     * Main window: move, insert, sort (hidden under insert)
  1634.     + Timeout has now two modes.
  1635.     + You can 'Add', 'New' and 'In' directories.
  1636.     + New The Player v6.1a replayer.
  1637.     + PT replayer causes no serialstops.
  1638.     + Command line: HIDE, QUIT.
  1639.     + Prefs: PS3M volume boost has immediate effect on music.
  1640.     + Included some support progs.
  1641.     · PSID-files are loaded in public mem if possible.
  1642.     · HiP can be hidden with lamiga-lshift-control+h.
  1643.     · Key for toggling current scope.
  1644.     · Uses less CPU than v1.40 when not playing.
  1645.     · Filebox routines optimized & jump scroll with shifts.
  1646.     · New algorithmic random generator (thanks Thomas!).
  1647.     · If PT replayer is set as 'Fastram', modules smaller than
  1648.       the replayer's chip buffers (256kB) will be loaded in chipram.. :)
  1649.     · Recognizes .Lha .lHa .lHA like suffixes too.
  1650.     · Only 8 channel Oktalyzer-tunes are loaded in fast ram.
  1651.     · Faster gadget disabling/enabling (OffGadget() was sloooow).
  1652.     · Fixed and enforcer hit when toggling prefs window.
  1653.     · Bug fix in the doc: the player table had some wrong info.
  1654.     · General good stuff and nice things.
  1655.         
  1656. v2.05 (3.5.1995)
  1657. ----------------
  1658.     * Some fixes and improvements here and there.
  1659.     * Keyboard: K/L swapped back with ARROW LEFT/ARROW RIGHT.
  1660.             Added lot's of functions to number pad.
  1661.     * MED: multisong support, song position/song length, forward,
  1662.            rewind, songend. Also no lib-error bug removed.
  1663.     * New PT FAST RAM replayer which uses only 1024 bytes of CHIP RAM.
  1664.     * Replaced GZip support with LZX.
  1665.     * New music formats: Mark II, Maniacs of Noise, David Whittaker,
  1666.                  BP SoundMon v3.0 (v2.2?).
  1667.     * Prefs: VBlank timing selector, switch for scope bars.
  1668.     - Added zoom-gadget (kick2.0+).
  1669.     - Directories are added recursively (kick2.0+).
  1670.     - Fix: PS3M with killer mode caused crashes (my fault).
  1671.     + Added Humble mode for PS3M: priority = -3.
  1672.     + PS3M mixing buffer size can be as high as 64kB.
  1673.     - Fix: randomgenerator bugged heavily (jammed the machine).
  1674.     - Fix: PT replayer patterndelay + volslide.
  1675.     - Double buffering: if not enough memory, dump current module and
  1676.       try again.
  1677.     - When adding modules via AppWindow or commandline they are
  1678.       added to the end of the list, instead of first clearing the list
  1679.       and then adding.
  1680.     - Filter status saved in prefs file. Wasn't saved in prev. versions!
  1681.     - File selection bar is always kept visible.
  1682.     - Better init error handling.
  1683.     - The sort routine is six times faster than before.
  1684.     - Priority affects all processes excluding HippoScope.
  1685.     - Windows adapt with different border sizes (works with sysihack).
  1686.     - Titlebar info: clock and free mem shown at the same time.
  1687.     - Keys works from prefs window too.
  1688.     - A new icon by Cyclone.
  1689.  
  1690. v2.06 (19.5.1995)
  1691. -----------------
  1692.     * External player group.
  1693.     + Selectable 8x8 pixel font (kick2.0+).
  1694.     + Title of the sample name window now contains name, comment and size.
  1695.     + Timing is done with CIAA timer. Serialstops should finally
  1696.       be gone now..
  1697.     - Hide had a big bug! Terminated it. (Hi Yolk! (I'm an idiot))
  1698.     - Fixed a bug in HiP-script (LZX extraction).
  1699.     - Pressing 'Use' in prefs window will also change the scope.
  1700.     - Fade volume on exit.
  1701.     - A new icon by Roman Patzner.
  1702.     - Fixed a bug in ZIP (ARexx).
  1703.     - Some PS3M bugs removed.
  1704.     - Some fixes...
  1705.  
  1706. v2.07 (26.6.1995)
  1707. -----------------
  1708. Bug fixes:
  1709. - Continue on error no longer causes neverending load and fail-loops.
  1710. - PS3M buffer max size reduced to 32kB (64kB didn't always work well).
  1711. - Removed a bug in the font selector (no more memory and time waste).
  1712. - 'New' clears the list only if some mods were selected.
  1713. - PT fastram player bug removed (the one that jammed the machine).
  1714. - Timeout works with doublebuffering now.
  1715. - LhAed TFMX mdat+smpl loading with doublebuffering had a really
  1716.   serious bug. Killed it.
  1717. - Another bug with LhA and TFMX removed. Probably caused crashes if
  1718.   the length of the MDAT file was odd.
  1719. - Pos/len and NS/PS didn't work with MED MMD2 modules (I don't have the
  1720.   format description!), so I removed them.
  1721. - ARexx command PLAY was documented misleadingly. Corrected.
  1722.     
  1723. Improvements:
  1724. - Little fixes and improvements here and there.
  1725. - Find files in list.
  1726. - Alarm clock! :)
  1727. - New music formats: Old Soundtracker, Hippel, Hippel-COSO.
  1728. - SID-info and sample name windows update when a new module is loaded.
  1729. - Totally new cycle gadget mult.choice requester with right mousebutton!
  1730. - 'Center name' improved so that doubleclicking is more easier.
  1731. - Option to show duration of Protracker modules.
  1732. - MED-player will try to allocate the serial port for playing MIDI
  1733.   modules.
  1734. - New PS3M replay version: 0.951. Lot's of bugs removed.
  1735. - Moved PS3M into player group.
  1736. - Config file for PS3M, like the one in PS3M the player by Guru.
  1737. - PS3M Surround stereo slider.
  1738. - PS3M Humble and Friendly modes replaced with priority selector.
  1739. - PS3M now uses CIAA timer which doesn't cause serial stops like CIAB.
  1740.   (The CIAB can be selected in the PS3M config if the user really wants.)
  1741. - New DMA wait routine for PT replayer by Peter Kunath.
  1742. - Changing scope will have immediate effect.
  1743. - No pop-screen-to-front at startup anymore.
  1744. - Improved LhA, LZX and Zip file indentification.
  1745. - Tools: WaitHiP, HiPlay, PSIDcomment.
  1746. - New MWB icons by Roman Patzner.
  1747. - New NewIcons icon by David Wiles.
  1748. - HiP.guide by Tuomas Lukinmaa.
  1749.  
  1750. v2.08 (21.7.1995)
  1751. -----------------
  1752. Bug fixes:
  1753. - 'Play Module once' bug removed.
  1754. - Changed to use the old DMA wait in the PT replayer because the new
  1755.   one didn't always work fine.
  1756. - Added RMB listselector for main program priority.
  1757. - Tried to play MED mods even when an init error occured. Fixd.
  1758. - PT module duration calculation routinetion [:-] locked up in some
  1759.   situations.  Fxd.
  1760. - PT module end-detect fix.
  1761. - PS3M configuration file parser had a bug.  Messed up priorities with
  1762.   killer mode.  Fd.
  1763. - Doublebuffering works with dropped-icon modules.
  1764. - Dropped modules get played immediately even with random play.
  1765. - PSID file identification with .info now recognizes more files.
  1766. - Crashed when couldn't open font.  F.
  1767. - Some problems fxd with song names and PS3M.
  1768. - 'Continue on error' failed with unknown modules.
  1769. - PT sampleoffset now actually works 100% correctly.  Hi Yolk & Guru!  :)
  1770. - Recognizes *.LZH.
  1771. - Major bug removed in random play..
  1772.  
  1773. Improvements:
  1774. - Added mouse waitpointer.
  1775. - Better MarkII, Hippel and Hippel-COSO identifying.
  1776. - Included a HiP brush by Roman Patzner.
  1777. - No volume fade on exit.
  1778. - Volume fade works a bit better with PS3M.
  1779. - Scope window is closed when no data is available.
  1780. - List selector in prefs can be cancelled by clicking outside the window.
  1781. - If a module that is played contains subsongs, all of them are played
  1782.   before next module is loaded.  Works with play modes 'List repeatedly' &
  1783.   'List once' and with end-detectable modules, and with timeout.
  1784.  
  1785. v2.09 (28.7.1995)
  1786. -----------------
  1787. AARGH!!  v2.08 had an old version of the PS3M!  :-(((((((((( This version
  1788. has the new one (same as the version in v2.07)...
  1789.  
  1790. Improvements:
  1791. - New scope
  1792. - A little change in PatternScope concerning VU-meters.
  1793.  
  1794. v2.10 (2.9.1995)
  1795. ----------------
  1796. Bug fixes:
  1797. - Some little ones here and there.
  1798. - DMA wait bug fixes: Protracker, JamCracker, Soundmon, Hippel-COSO.
  1799.   Lost notes on screenmodes with high refresh rate.
  1800. - Enforcer hit with right mousebutton removed.
  1801. - Commandline stuff bugs removed.
  1802. - Enforcer hits with scopes fixed.
  1803.  
  1804. Improvements:
  1805. - List dividers.
  1806. - Filename prefix cut.
  1807. - Early load.
  1808. - New fast forward mode.
  1809. - RMB function indicators (DOpus style).
  1810. - New Prefs organization.
  1811. - Changed the position of 'cursor' in patternscope.
  1812. - IFF 8SVX sample playing.
  1813. - Added SAMPLES ARexx command.
  1814. - ARexx command PLAYSONG bugged. Replaced with SONGPLAY that works.
  1815. - Little interface for programmers.
  1816. - Thickened the quadra/stereoscopes.
  1817. - Moved the info from the title of the sample window into the window itself.
  1818. - The position of the sample name window and the info window are saved.
  1819. - Sample windows not opened by the user no longer inactivate the main
  1820.   window.
  1821. - Join module lists with RMB and 'Lp'.
  1822. - Improved sort routine:
  1823.    * Sorting accuracy 24 characters
  1824.    * Divided sections are sorted separatedly
  1825.    * Prefix cut compatible
  1826.    * Not very fast. I'm still using bubble sort...
  1827. - Skip setting of values in PS3M config file with ?'s.
  1828. - Included Filer-ARexx script by Janne Simonen.
  1829. - Increased PS3M maximum mixingrate from 56 kHz to 58 kHz after finding out
  1830.   it is actually possible.
  1831. - HippoScope for PS3M:  doubled the vertical pixel size, doubled the amount
  1832.   of pixels on 020+ Amigas.
  1833. - NOTE THIS:  The PRG keyword has been changed to PRGM!
  1834.  
  1835. v2.11 (6.9.1995)
  1836. ----------------
  1837. Bug fixes:
  1838. - Some little fixes.
  1839. - v2.10 had a test version Protracker replayer...  Argh!  :( Well it works
  1840. fine and is faster but doesn't always sound the same as the original
  1841. Protracker.  So back to the old replayer in this version.
  1842.  
  1843. Improvements:
  1844. - Scope opens again when possible.
  1845. - Dir add with divider/dir now adds dividers to all dirs.
  1846.  
  1847.  
  1848. v2.12 (16.9.1995)
  1849. -----------------
  1850. Bug fixes:
  1851. - Some.
  1852.  
  1853. Improvements:
  1854. - Redone the programmer interface.
  1855. - External scopes included.
  1856. - Example scope source included.
  1857. - Loading progress indicator for XPK files.
  1858. - Filled stereoscope for PS3M.
  1859. - Hipposcope for PS3M:  2x1 pixels instead 1x2 pixels.  Also no extra dots
  1860. with 020+ CPUs anymore.
  1861.  
  1862.  
  1863. v2.20 (27.10.1995)
  1864. ------------------
  1865. Bug fixes:
  1866. - Some..
  1867. - PS3M stereo didn't get updated unless the Prefs window was opened.
  1868. - hip_play in HiP's port wasn't updated!  Fixed.
  1869. - Nasty bug defeated in font requester! Corrupted the archiver commands..
  1870. - Some fixes in PT replayer.
  1871. - Bug fixed in Examplescope-source.
  1872.  
  1873. Improvements:
  1874. - New prefs system with paging.
  1875. - Listview for module info (sample names, PSID-info etc)
  1876. - New PS3M:  0.959 (20.9.1995).  NOTE!  The XM player is from the old PS3M,
  1877.   because the new XM player sucked..  Hi Guru!
  1878. - Removed the CIA selector from HippoPlayer.PS3M, currently PS3M always
  1879.   uses CIAA if possible.
  1880. - Pattern match for file requester.
  1881. - XFDmaster.library support for loading all kinds of packed files.
  1882. - Support for Alexis Nasr's combined TFMX mdat+smpl format (TFHD).
  1883. - If there's not enough chip memory, unpacked and XPK packed (with XPK
  1884.   identify) PT modules will be loaded to fast memory.
  1885. - If possible, CIAB is used for DMA wait.  No interrupts included!
  1886. - Better Old Soundtracker idenfication.
  1887. - Max timeout increased to 30 mins.
  1888. - Alarm now has a slider (hh:mm).
  1889. - Included xVUmeter.
  1890. - Included HiPScope with the C source and header file by Thomas Skoldenborg.
  1891.  
  1892. v2.21 (16.12.1995)
  1893. ------------------
  1894. Bug fixes:
  1895. - Quite a bunch removed.
  1896. - Found & killed many memory mangling bugs.
  1897. - Scope 'data follow speed' problems fixed.  Should work on all the
  1898.   standard monitor drivers.
  1899.  
  1900. Improvements:
  1901. - New, fast and amazing LhA/LZX/Zip loader that scans each archive for
  1902.   music modules! Archives with 100 BBS adverts and one module will work
  1903.   fine.  BTW, delete the HiP-script file.  It's no longer needed.
  1904.  
  1905. - New mode for player group: Load single.
  1906.  
  1907. - Info & main window scrolling now with optimized blitter power.
  1908. - PS3M mixing rate printed into the info window.
  1909. - Info window open/close status saved in prefs file.
  1910.  
  1911. - DIGI Booster support.  May be removed from the later releases.  You
  1912.   should try out the tracker, it's great.  Thanks to Tomasz Piast (Tap)
  1913.   for giving me the replayer source.
  1914.  
  1915. - Exit the module info by pressing Escape (in the window that is).
  1916. - Nuke key: [BACKSPACE+SHIFT]. Will remove a file from the list as well as
  1917.   from the DISK!
  1918.  
  1919. - Bigger jump in PSID fast forward.
  1920. - Two new parameters for ARexx GET: DURA and HIDS.
  1921.  
  1922. - Some cosmetic changes.
  1923.  
  1924. - Included installer-script by Tomasz Kepa.  Thanks! 
  1925.   Some modifications by me.
  1926. - Included French docs by Alan Guillevic. Thanks!
  1927. - Included HiP-ARexx-Play.rexx script by Marcel Döring
  1928.   <DonDoringo@GURU.rhein-main.de>.  Thanks!
  1929. - Included a Hippo drawer icon by Richard Harris. Thanks!
  1930.  
  1931.  
  1932. v2.22 (26.12.1995)
  1933. ------------------
  1934. Bug fixes:
  1935. - Forgot to fix in the last version:  info window could only open to
  1936.   Workbench screen. 
  1937. - Player group handling had a random memory allocation bug..  :(
  1938. - PS3M is known to cause crashes when writing to floppy.  I did something
  1939.   to the PS3M interrupt servers and the problem seems to be gone now.
  1940.   Who knows for sure...
  1941. - Installer script fixed. Tried to copy the obsolete HiP-script too.
  1942.  
  1943. Improvements:
  1944. - MED sample names are shown in the info window if possible.
  1945. - List dividers don't count as files anymore in the about window.
  1946. - Included SPIScope by Tuomas Lukinmaa.
  1947.  
  1948.  
  1949.  
  1950. v2.23 (7.4.1996)
  1951. ----------------
  1952.  
  1953. Bug fixes:
  1954. - A multitude of major & minor bugs removed.
  1955. - A severe bug in Load Single player group mode removed.
  1956. - Alarm fixed. Probably didn't work at all.
  1957. - Something fixed in VUMeter, shouldn't crash anymore.
  1958.  
  1959. Improvements:
  1960. - Quality assurance by a bunch of betatesters (yeah, sure :-)
  1961.  
  1962. - New PS3M 0.960.  Bugs fixed in Fasttracker II (XM), Screamtracker III
  1963.   (S3M) and Fasttracker I (FT) replay routines.  Fixed & updated by Peter
  1964.   Kunath / Delirium Softdesign (Hi!  Thanks!)
  1965.  
  1966. - SHIFT+BACKSPACE on a divider causes all the files 'under' that particular
  1967.   divider to be deleted from the list.
  1968. - Added RMB function for Del.  The same as SHIFT+BACKSPACE = delete file or
  1969.   delete divider and the files under it.
  1970.  
  1971. - RMB on the left 1/3 of the infobox = scope on/off.
  1972.  
  1973. - Info window: show the whole filecomment.
  1974.  
  1975. - Monoscope and filled monoscope for IFF sample player.
  1976.  
  1977. - Will now try CIAA first and then CIAB for timing.  Should work with
  1978.   other apps that require CIAA, like Shapeshifter.
  1979.  
  1980. - New DigiBooster replayer v1.4 by Tap.  (BEWARE:  the replayer
  1981.   causes non-lethal enforcer hits!)
  1982. - Added volume control for DigiBooster modules.
  1983.  
  1984. - Prefs: Prefs page saved in the prefs file.
  1985. - Prefs: Use/don't use HippoPlayer.PS3M configuration file.
  1986. - Prefs: Save window zip status (big window/title bar).
  1987. - Prefs: Sample buffer size.
  1988. - The file match pattern is now applied to all filenames, not only to those
  1989.   shown in the filerequester (kick2.0+).
  1990. - Filebox size can be set to 0: remove the whole thing from the window.
  1991.  
  1992. - LhA archive extraction should work on kick1.3 now.
  1993.  
  1994. - Player group mode 'Load all' will load med and psidplayer libraries.
  1995. - Module name in titlebar in all but 'Show clock, free mem'.
  1996.  
  1997. - ARexx GET: FILT
  1998. - ARexx: Some new scripts added. Check them out.
  1999.  
  2000. - Scopes can be run from WB.
  2001.  
  2002. - Included a MWB drawer icon and MWB icons for scopes.  Thanks go to Ilmari
  2003.   Karonen for these.
  2004. - Some history cut from the doc.
  2005.  
  2006.  
  2007. v2.30 (5.8.1996)
  2008. ----------------
  2009.  
  2010. Bug fixes:
  2011. ¯¯¯¯¯¯¯¯¯¯
  2012. - Numerous!
  2013. - More urouhack compatible.
  2014. - Fixes in the sort routine and in the recursive file add.
  2015. - Added some security to the PS3M killer mode.  Don't know if it made any
  2016.   difference.
  2017.  
  2018.  
  2019. Major improvements:
  2020. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  2021. - New GUI look.
  2022.  
  2023. - Mega major enchancements in the sample player:  IFF, AIFF, RIFF
  2024.   WAVE, mono/stereo 8/16-bit support, stop cont, end detect, duration
  2025.   calculation. 8/14-bit playing.
  2026.  
  2027. - Protracker sample playing in the module info window! Finally after
  2028.   lot's of public pressure :)
  2029.   Click a sample to play. The horizontal position of the mouse pointer
  2030.   defines the note.
  2031.  
  2032. - Support for THX Sound System modules.  Great chip tunes!
  2033.   Needs 68020+ to work.
  2034.  
  2035. - Archives (LhA, LZX, Zip):
  2036.   · A proper file identification in the archive extraction.
  2037.   · LhA, LZX and Zip archives without the suffix (.lha, .lzx, .zip)
  2038.     can be now loaded. This feature needs some changes in the archiver
  2039.     commands, so be sure to change them!
  2040.  
  2041. - CyberSound calibration file support for PS3M. Totally amazing
  2042.   14-bit quality!
  2043.  
  2044. - 'About' uses the module info window routines, no more reqtools.
  2045.  
  2046. - DIGI Booster sample names can be viewed in the module info window.
  2047.  
  2048. - Much improved guide-file. Hi Marius! :)
  2049.  
  2050.  
  2051. Minor improvements:
  2052. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  2053. - Scopes now support quitting when HiP tells them to.  Also the can be quit
  2054.   by clicking right mousebutton on the active scope window.
  2055.  
  2056. - Shift + I not only opens the moduleinfo window but also activates it.
  2057.  
  2058. - Pressing RMB on the module info window or about window will cause
  2059.   the window to be closed.
  2060.  
  2061. - Prefs: the string gadgets are now cyclable with TAB.
  2062.  
  2063. - Right mousebutton on the prefs gadget |Pr| will remove/restore the main 
  2064.   window filebox.
  2065.  
  2066. - Keyboard changes:
  2067.   · Two new key functions: [G] and [H] for playmodes 'list repeatedly' 
  2068.     and modules in random order'.
  2069.   · New key assignments:
  2070.     · Clear modulelist = [C]
  2071.     · Delete module = [D], [BACKSPACE]
  2072.     · Volume = [V], [B]
  2073.     · New = [N]
  2074.   ·   Prefs = [R]
  2075.  
  2076. - A new XPK load progress indicator.
  2077.  
  2078. - In 'Play modules in random order' mode the modules already played
  2079.   will be marked with '#' in the list.
  2080.  
  2081. - Adding files and dirs works more logically now.
  2082.  
  2083. - Added some reason to the init error management.
  2084.  
  2085.  
  2086. New support stuff:
  2087. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  2088. - New MWB icon by Trevor Morris.
  2089. - New ARexx-script: Suffer.rexx by Marcel Döring. 
  2090. - New ARexx-scripts: hip_play1b.rexx, hip by Filip "Eliot"
  2091.   Oscadal.
  2092. - New version of the HippoPlay.filer ARexx-script by Janne Simonen.
  2093.  
  2094.  
  2095.  
  2096. v2.32 (6.10.1996)
  2097. -----------------
  2098.  
  2099. Bug fixes:
  2100. ¯¯¯¯¯¯¯¯¯¯
  2101. - Fixed some problems related with `HIDE' command line parameter.
  2102. - Window didn't refresh properly when zipping shrinked main window. Fixed.
  2103. - When loading archived TFMX modules HiP didn't delete the temp directory.
  2104.   Fxd.
  2105. - Some other little bugs removed. There's no end to these.. :-\
  2106. - Some fixes in the .guide file.
  2107.  
  2108. Improvements:
  2109. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  2110. - AHI audio system support. Needs kick2.0+ and (probably) 68020+.
  2111.   
  2112. - New DIGI Booster replayer v1.6. Thanks Tap & Walt!
  2113.  
  2114. - PS3M:
  2115.   · 020+ mixing routines optimized a bit.
  2116.   · Some fixes in the replayers.
  2117.  
  2118. - Sample player:
  2119.   · 020+ optimizations.
  2120.   · Moved into player group.
  2121.   · The sampling rate can be set from prefs. This overrides the rate
  2122.     got from the sample's header. Hi Icebeat :)
  2123.  
  2124. - Auto sort option in Prefs.
  2125.  
  2126. - Major byte shaving throughout the source.
  2127.  
  2128. - Updated the doc file. It's still as messy as ever.. Guides rule.
  2129.  
  2130. - A new and improved installer script. 
  2131.  
  2132. - Renamed the ARexx scripts to *.HiP.
  2133.  
  2134. New support stuff:
  2135. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  2136. - New external scopes:  Small versions of Quadrascope, FQuadrascope and
  2137.   HippoScope.  WeirdScope the weird scope for PT.  A BigScope pattern
  2138.   scroller & quadrascope for the whole screen (needs kick 3.0+).
  2139.  
  2140. - Italian docs translated by Valerio Russo. Did you get my letter?
  2141. - Polish docs translated by Tomasz Kepa.
  2142. - New ARexx script: Totalduration.hip by Tomasz Kepa.
  2143.  
  2144.   Thanks a lot people! :)
  2145.  
  2146.  
  2147.  
  2148. v2.33 (8.10.1996)
  2149. -----------------
  2150. - A patch released to fix the player group bug (see below).
  2151.  
  2152.  
  2153.  
  2154. v2.34 (12.10.1996)
  2155. ------------------
  2156.  
  2157. Bug fixes:
  2158. ¯¯¯¯¯¯¯¯¯¯
  2159. - The player group loader only accepted the group if the player group 
  2160.   mode was set to `Load single'. Fixed.
  2161. - The Protracker sampleplaying feature in the infowindow didn't work.
  2162.   Fixed.
  2163. - Some fixes in the AHI support stuff.
  2164.  
  2165. Improvements:
  2166. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  2167. - Disassembled and fixed the THX replayer so that it now works
  2168.   on 68000/68010 too. 
  2169.  
  2170.  
  2171.  
  2172.  
  2173. v2.35 (23.11.1996)
  2174. ------------------
  2175.  
  2176. Bug fixes:
  2177. ¯¯¯¯¯¯¯¯¯¯
  2178. - Fixed a bug regarding the random play mode and the Play-button.
  2179. - The lame & futile early load function had a bug. Fixed. 
  2180. - A nasty bug fixed in the sample playing stuff conserning the player
  2181.   group. 
  2182.  
  2183. Improvements:
  2184. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  2185. - Support for MusiclineEditor modules (using mline.library).
  2186. - Support for OctaMed SoundStudio modules (using octamixplayer.library).
  2187.  
  2188. - Optimized the sort routine a bit.
  2189. - Optimized the PT fast ram player (speed up on 68000/010).
  2190. - Find name -function now always scans the whole list.
  2191.  
  2192. New support stuff:
  2193. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  2194. - Updated French guide by Alan Guillevic. Thanks!
  2195.  
  2196.  
  2197.  
  2198. v2.36 (27.12.1996)
  2199. ------------------
  2200.  
  2201. ** NOTE!  From v2.35 on, HiP requires V6 versions of medplayer.library and
  2202. octaplayer.library, and V7 version of octamixplayer.library.  All the
  2203. required libraries are now included in the archive!
  2204.  
  2205. Bug fixes:
  2206. ¯¯¯¯¯¯¯¯¯¯
  2207. - Removed the previous fix in random play and play button..
  2208. - Some small bugs removed.
  2209. - Did something with the archive temp dir cleanup.
  2210.  
  2211. Improvements:
  2212. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  2213. - Modules that are best played from fast ram but are loaded in chip ram
  2214.   will now be moved to fast ram if possible.
  2215. - RMB list selectors in Prefs can be cancelled by clicking RMB again.
  2216.  
  2217. New support stuff:
  2218. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  2219. - Included all the required player libraries in the archive:
  2220.   · medplayer, octaplayer and octamixplayer.library for MED, OctaMED and
  2221.     OctaMED SoundStudio modules.
  2222.   · PlaySID.library for playing PSID modules.
  2223.   · mline.library for playing MusiclineEditor modules.
  2224.   All are installed by the supplied install script.
  2225.  
  2226. - German guide by Dominik Deobald. Thanks!
  2227. - Multi-archive-multi-file-player-script HiPPack v1.2a by Jari Karjalainen. 
  2228.   Thanks!
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234. ******************************************************************************
  2235. *                               *** Hellos ***                            *
  2236. ******************************************************************************
  2237.  
  2238. Jarno Paananen (Guru/Sahara Surfers)
  2239. - Hi pal! Thanks for the PS3M etc. :)
  2240.  
  2241. Nico François
  2242.  - Thanks for the reqtools.library!
  2243.  
  2244. Ron Birk & Per Håkan Sundell
  2245. - Thanks for making almost perfect SID-emulation.
  2246.  
  2247.  
  2248. Official beta testers:
  2249. ----------------------
  2250. Jarkko Kemppainen (Mysdee/The Sharks), Mikko Karvonen (Yolk/Parallax), Timo
  2251. Rönkkö (Deadbeat/The Sharks), Antti Lankila (STL/Damage), Jarkko
  2252. Vatjus-Anttila (Quaid/Big Fat Brothers), Tuomas Lukinmaa (Tumu/Big Fat
  2253. Brothers), Toni "Panadol" Kettula, Filip "Eliot" Oscadal, Marcel Döring,
  2254. Steve@Almathera Tech (THP), Kasper B.  Graversen, Marius Sundbakken, Luuk
  2255. van der Duim, Jan Svihus
  2256.  
  2257.  
  2258. Those who have participated more or less, thanks:
  2259. -------------------------------------------------
  2260. Peter Kunath (Delirium Softdesign), Henryk Richter (Buggs/Defect), Tuomas
  2261. Lukinmaa (Tumu/BFB Team), Janne Simonen, Marcel Döring, Tomasz Kepa, Jarkko
  2262. Vatjus-Anttila (Quaid/BFB Team), Marius Sundbakken, Christian Buchner.
  2263. Alan Guillevic, Valerio Russo, Dominik Deobald
  2264.  
  2265. Icons by:
  2266. ---------
  2267. Tommi Lindström, Richard Harris (FOXX), cYClone/nEW-dEAL^PSD PC, Roman
  2268. Patzner, David Wiles, Ilmari Karonen, Trevor Morris
  2269.  
  2270. Special hellos:
  2271. ---------------
  2272. Agust Arni Jonsson (Nemesis1), Mikael Grahn, Jari Karjalainen, Ivan
  2273. Wheelwright, Jani Kannisto, Thomas Gylfe, Arto Ikola, Tommi Lempinen, Paul
  2274. Wellstead, Mikko Vartio, Pasi Laaksonen, Alan Guillevic, Armin Pigulla,
  2275. Mikko Manninen, Seppo Tomperi, Jari Mikkilä, Patrick Becker, P. Koistinen,
  2276. Juha Laukkanen, Jan Svihus, Gunnar Andersson, Ragnar Fyri, Roman Patzner,
  2277. Edouardo Gonçalves, Svein Skjæveland, Petri Ala-Louesniemi, Jari Ketola,
  2278. Olivier Delemotte, Markku Luukkainen, Ralf Neitzel, Janne Jusula, Philippe
  2279. Bovier, Jouko Tuisku, Luuk van der Duim, Sean Connolly (Odie/Cosine), Johan
  2280. Rönnblom, Dominique Deangeli, Norbert Pfohl, Graham C. Shaw, Josef
  2281. Andersson, Samppa Rönkä, Juha Virtanen, Jorma Valli, Moku/Assembly
  2282. Organizing, Wayne Newark, Mikko Uusitalo, Arto Bäckman, James Abrams,
  2283. Kieron Dunbar, Toni Kettula, Timo Koskinen, Garret McGowan, Christian
  2284. Knieling, Christer Bjarnemo, Sami Sainio, Lukás Smolej, Morgan Johansson,
  2285. Øystein Monsen, Otto Vara, Mikael Berglund, Kimmo Lappalainen, Niels de
  2286. Koning, Juhana Uuttu, Jaakko Oranen, Richard Knight, Peter Mattsson, Heikki
  2287. Jämsä, Ján Zahurancik, Mikko Rönkkönen, Jani Sarviluoma, Aki Laukkanen,
  2288. Fredrik Jansson
  2289.  
  2290. Hellos to those who have sent me email and to whom I've talked on IRC.
  2291.  
  2292. Thanks to all the ones who have sent me registrations, bug reports &
  2293. suggestions!
  2294.  
  2295.  
  2296.  
  2297.  
  2298. ******************************************************************************
  2299. *                              *** About ***                           *
  2300. ******************************************************************************
  2301.  
  2302. HippoPlayer was made by using the Asm-One.  Pure tricky optimized
  2303. assembler, source code length without any includes or play routines is
  2304. about 435kB.
  2305.  
  2306. Registrations, bug reports, comments & suggestions and C-64 warez are
  2307. welcome!  NO SWAPPING!!
  2308.  
  2309. Always mention your Amiga configuration and HiP version when sending bug
  2310. reports!
  2311.  
  2312.  
  2313.  Kari-Pekka Koljonen
  2314.  Torikatu 31
  2315.  FIN-40900 Säynätsalo
  2316.  Finland
  2317.  
  2318.  
  2319.  E-mail: k-p@kalahari.ton.tut.fi   (try this first)
  2320.      kpk@pcuf.fi           (try this second, no files here!)
  2321.  
  2322.  WWW:     http://kalahari.ton.tut.fi/~k-p
  2323.  
  2324.  IRC:     K-P (#amigascne)
  2325.  
  2326.  Finns phone: 014-3742699 (weekends only)
  2327.  
  2328.